home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3x / aspidsinash.z / aspidsinash
Encoding:
Text File  |  2001-04-17  |  7.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. aaaassssppppiiiiddddssssiiiinnnnaaaasssshhhh((((3333xxxx))))                                                aaaassssppppiiiiddddssssiiiinnnnaaaasssshhhh((((3333xxxx))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      aspidsinash, aspidsinash_array, aspidsinash_local, aspidsinash_server -
  10.      enumerate processes in an array session
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ttttyyyyppppeeeessss....hhhh>>>>
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<aaaarrrrrrrraaaayyyyssssvvvvccccssss....hhhh>>>>
  15.  
  16.      aaaassssppppiiiiddddlllliiiisssstttt____tttt     ****aaaassssppppiiiiddddssssiiiinnnnaaaasssshhhh((((aaaasssshhhh____tttt AAAASSSSHHHH))));;;;
  17.      aaaassssaaaarrrrrrrraaaayyyylllliiiisssstttt____tttt   ****aaaassssppppiiiiddddssssiiiinnnnaaaasssshhhh____aaaarrrrrrrraaaayyyy((((aaaasssssssseeeerrrrvvvveeeerrrr____tttt SSSSeeeerrrrvvvveeeerrrr,,,,
  18.                                         ccccoooonnnnsssstttt cccchhhhaaaarrrr ****AAAArrrrrrrraaaayyyyNNNNaaaammmmeeee,,,, aaaasssshhhh____tttt AAAASSSSHHHH))));;;;
  19.      aaaassssppppiiiiddddlllliiiisssstttt____tttt     ****aaaassssppppiiiiddddssssiiiinnnnaaaasssshhhh____llllooooccccaaaallll((((aaaasssshhhh____tttt AAAASSSSHHHH))));;;;
  20.      aaaassssmmmmaaaacccchhhhiiiinnnneeeelllliiiisssstttt____tttt ****aaaassssppppiiiiddddssssiiiinnnnaaaasssshhhh____sssseeeerrrrvvvveeeerrrr((((aaaasssssssseeeerrrrvvvveeeerrrr____tttt SSSSeeeerrrrvvvveeeerrrr,,,, aaaasssshhhh____tttt AAAASSSSHHHH))));;;;
  21.  
  22. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.      The "aspidsinash" functions return lists of process IDs that belong to
  24.      the array session specified by the array session handle AAAASSSSHHHH.  Each
  25.      function returns its list in a data structure that is defined in
  26.      <<<<aaaarrrrrrrraaaayyyyssssvvvvccccssss....hhhh>>>>.  The storage for these structures are allocated using
  27.      _m_a_l_l_o_c(3C), and should be released with the appropriate function noted
  28.      below when it is no longer needed.
  29.  
  30.      The SSSSeeeerrrrvvvveeeerrrr argument specifies an optional array server token, which can
  31.      be used to direct the request to a specific array services daemon.  If
  32.      NULL is specified instead, the request will be processed by the default
  33.      array services daemon if necessary (see _a_r_r_a_y(1) for more information on
  34.      how the default array services daemon is selected).  For more details on
  35.      creating an array server token, see _a_s_o_p_e_n_s_e_r_v_e_r(3X).
  36.  
  37.      _a_s_p_i_d_s_i_n_a_s_h__l_o_c_a_l returns only those processes in the array session that
  38.      are running on the local machine.  The list of process IDs is returned in
  39.      an aaaassssppppiiiiddddlllliiiisssstttt____tttt structure, which may be freed using _a_s_f_r_e_e_p_i_d_l_i_s_t(3X).
  40.      _a_s_p_i_d_s_i_n_a_s_h is the same as _a_s_p_i_d_s_i_n_a_s_h__l_o_c_a_l, and is retained mainly for
  41.      backward compatibility.  Unlike the remaining functions,
  42.      _a_s_p_i_d_s_i_n_a_s_h__l_o_c_a_l and _a_s_p_i_d_s_i_n_a_s_h do not require the array services
  43.      daemon to be running in order to complete successfully.
  44.  
  45.      _a_s_p_i_d_s_i_n_a_s_h__s_e_r_v_e_r returns the list of processes in the specified array
  46.      session that are running on the machine specified by SSSSeeeerrrrvvvveeeerrrr.  The list is
  47.      returned in aaaassssmmmmaaaacccchhhhiiiinnnneeeeppppiiiiddddlllliiiisssstttt____tttt, which may be freed using
  48.      _a_s_f_r_e_e_m_a_c_h_i_n_e_p_i_d_l_i_s_t(3X).
  49.  
  50.      _a_s_p_i_d_s_i_n_a_s_h__a_r_r_a_y returns a list of processes in the specified array
  51.      session for all of the machines in the array specified by AAAArrrrrrrraaaayyyyNNNNaaaammmmeeee.  The
  52.      data is returned in the form of an aaaassssaaaarrrrrrrraaaayyyyppppiiiiddddlllliiiisssstttt____tttt, which may be freed
  53.      using _a_s_f_r_e_e_a_r_r_a_y_p_i_d_l_i_s_t(3X).  The aaaassssaaaarrrrrrrraaaayyyyppppiiiiddddlllliiiisssstttt____tttt in turn contains
  54.      pointers to one or more aaaassssmmmmaaaacccchhhhiiiinnnneeeeppppiiiiddddlllliiiisssstttt____tttt's, one for each machine in the
  55.      array.  Each aaaassssmmmmaaaacccchhhhiiiinnnneeeeppppiiiiddddlllliiiisssstttt____tttt contains the name of the particular
  56.      machine and a list of the processes in the specified array session that
  57.      are running there.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaassssppppiiiiddddssssiiiinnnnaaaasssshhhh((((3333xxxx))))                                                aaaassssppppiiiiddddssssiiiinnnnaaaasssshhhh((((3333xxxx))))
  71.  
  72.  
  73.  
  74. NNNNOOOOTTTTEEEESSSS
  75.      Notice that because processes and array sessions can come and go over
  76.      time, this information cannot be 100% accurate; it may omit some new
  77.      processes and/or include processes that have already terminated.
  78.  
  79.      All of the functions are found in the library "libarray.so", and will be
  80.      loaded if the option "-larray" is used with _c_c(1) or _l_d(1).
  81.  
  82.      The array services daemon, _a_r_r_a_y_d(1M) must be running on all affected
  83.      machines for the functions _a_s_p_i_d_s_i_n_a_s_h__a_r_r_a_y and _a_s_p_i_d_s_i_n_a_s_h__s_e_r_v_e_r to
  84.      work properly.
  85.  
  86. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  87.      asashisglobal(3X), aserrorcode(3X), asfreearraypidlist(3X),
  88.      asfreemachinepidlist(3X), asfreepidlist(3X), aslistashs_server(3X),
  89.      array_sessions(5).
  90.  
  91. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  92.      _a_s_p_i_d_s_i_n_a_s_h returns a pointer to an aaaassssppppiiiiddddlllliiiisssstttt____tttt structure if successful
  93.      or NULL if not.  If unsuccessful, _a_s_e_r_r_o_r_c_o_d_e will be set appropriately.
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.